Mapping folder properties

Similar to how it replicates documents, the Global Collaboration Framework can also replicate folders. The folders can be normal folders, folders created with custom folder types and custom properties, or project folders. The folder types and folder properties that are replicated must be configured identically in both systems. You map the folder properties from Meridian Enterprise to the transfer briefcases in the briefcase template in Meridian Enterprise Configurator that is used by the GCF and you map the folder properties from the briefcases to BlueCielo Project Portal in the processor configuration file. For more information on configuring briefcase templates, see the BlueCielo Meridian Global Collaboration Framework Configuration Guide.

Notes

• Folder property replication is only supported by Meridian Enterprise 2011 and higher when using custom briefcase formats. For more information about custom briefcase formats, see the BlueCielo Meridian Enterprise Configuration Guide.

• Some BlueCielo Project Portal system-defined document properties and folder properties can also be mapped in the briefcase template.

To map Meridian Enterprise folder properties to the briefcase template:

1. In Meridian Enterprise Configurator, for each folder property that you want to replicate, define a property in the briefcase template .
2. Create or edit the FolderSettings setting of the GCF briefcase template. The value of this setting is the name of a section of property mappings, for example, MyFolderSection.
3. On an empty line, create a property mapping section that begins with the value of the FolderSettings setting surrounded by square brackets, for example, [MyFolderSection].

4. On consecutive lines in the property mapping section, list the briefcase properties that you created in step 1 and the corresponding folder property names that you want to replicate, one line per property. For each property, specify the vault property set and property name that you want to replicate. The property mapping section is independent of the folder types that are used, so map all properties that are used by all folder types that will be used for collaboration.

   Use the following format for each line:

   <BriefcasePropertyName>=<PropertySetName.PropertyName>,<Flag>

   Unlike replicated documents, folders do not have an owner so that folder property changes can be replicated in every direction. To avoid overwriting property values, set the vault security accordingly on the folders at each site. Alternatively, at each collaborating site, configure the Flag parameter to indicate whether the folder property should be read-only (RO), read/write (RW), or write-only (WO) at that site. By default, all properties are read/write.

Following is an example folder property mapping section:

[Settings]
BriefcaseSettings=GCF

[GCF]
FolderSettings=PortalFolderSection

[PortalFolderSection]
gcfProjectName=PSProject.Name, WO
gcfProjectCode=PSProject.Code, RO
gcfManager=PSProject.Manager, WO

To map the briefcase folder properties to BlueCielo Project Portal folder properties:

1. Open the processor configuration file in any text editor.

2. Add a line to the [BlueCieloECM.InnoCielo.Collaboration.GCFProcessor] section for each  folder property that you mapped in the preceding task. Use the following syntax:

   FolderFieldMapping_<N>=<Column>;<Property>

   Where:

   • FolderFieldMapping_<N>: Numbered mapping keyword
   • <Column>: Internal BlueCielo Project Portal property code
   • <Property>: Meridian Enterprise briefcase property name

Following are example folder property mappings:

[BlueCieloECM.InnoCielo.Collaboration.GCFProcessor]
FolderFieldMapping_1=gcfProjectName;ProjectName
FolderFieldMapping_2=gcfProjectCode;ProjectCode
FolderFieldMapping_3=gcfManager;Manager